home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr35 / scani02b.zip / SCANIT.DOC < prev    next >
Text File  |  1995-01-09  |  19KB  |  399 lines
  1.            ┌╦═══╦┐ ┌╦═══╦┐ ┌╦═══╦┐ ┌╦═╗ ╦┐ ┌═╤╦╤═┐ ┌═╤╦╤═┐ ╒╦╕
  2.            └╩═══╦┐ │║      ├╬═══╬┤ │║ ║ ║│   │║│     │║│   ╘╩╛
  3.            └╩═══╩┘ └╩═══╩┘ └╩   ╩┘ └╩ ╚═╩┘ └═╧╩╧═┘   ╧╩╧   └╩┘
  4.                   Copyright (c) 1994 - Blake Software
  5.                        A WildStuff (tm) Utility!
  6.  
  7.            An inexpensive archive/virus tester for WildCat 4.x!
  8.  
  9. [ About SCANIT! ]
  10. This is a *BETA* version of SCANIT that is fully operational with
  11. .EXE, .ZIP, and .ARJ files.  It has been designed to use version
  12. 2.x (or higher) of McAfee's SCAN.  I have been running it on my
  13. BBS for a couple of months with no problems, and it has been
  14. running the same amount of time at 14 BETA sites (both single
  15. and multi-line) with no reported problems.
  16.  
  17. This version of SCANIT is FREE!  You can run it for as long as you
  18. like at no cost.  The final release of SCANIT _will_ require a $10.00
  19. registration fee and a key file to operate in *registered* mode.
  20.  
  21. CONDITIONS FOR RUNNING SCANIT!
  22. You can run this BETA version FREE OF CHARGE. But (here's the catch!),
  23. you must:
  24. 1) In your archive comment (ZIP/ARJ comment file), you _must_ state
  25. that the file was tested using SCANIT! from Blake Software.
  26.  
  27. 2) Accept full responsiblity for any problems that arise from the use
  28. of SCANIT!. Your use of SCANIT! is your agreement to accept all
  29. responsiblity for its' use.
  30.  
  31. 3) Report any problems you encounter with SCANIT! to me so I can
  32. get it fixed!
  33.  
  34. Not too bad, I guess.  There could be additional updates to this
  35. WIDE BETA release before SCANIT! goes final.  These updates will
  36. be free of charge, as well.  For those of you that would like to
  37. go ahead and send in your $10.00, please DON'T at this time! Please
  38. wait until SCANIT! is complete (Thanks!).
  39.  
  40. [ Version .02b (BETA) ]
  41. *NOTICE TO ALL BETA SITES!*
  42. This version of SCANIT is limited in what it will scan.  In other words,
  43. I haven't built in all of the functions yet that I plan on implementing.
  44. This version is ONLY capable of scanning the following files with
  45. McAfee's Scan: .EXE, .ZIP, .ARJ.  It will _ATTEMPT_ to scan any other
  46. file type that you have not excluded from your system when uploaded (more
  47. about this later in this text), but there is no guarantee that it will
  48. be accurate at this point (SCAN works with MOST files, but there are some
  49. that it can not actually virus check, such as archived files other than
  50. ZIP and ARJ files; example: JUNK.ARC).
  51.  
  52. I DO plan on implementing support for .LZH (LHArc) files in a future
  53. release.  Other archive formats I *MIGHT* possibly support if YOU
  54. ask for it!  PKZIP and ARJ (plus LHARC) seem to be the most widely used,
  55. therefore I wrote SCANIT to work with them. Personally, I prefer
  56. PKZIP and, while I allow ARJ files on my BBS, I do ask my users to
  57. upload files that have been ZIPPED. Why?  Most folks out there use
  58. PKZIP and are comfortable with its' use. Even the novice (and SUB
  59. novice users <grin>) can figure out PKZIP without too much trouble.
  60. When a caller downloads a file from my BBS, it's almost always in
  61. ZIP format so they can easily unzip it and put it to work.  In other
  62. words, it's a personal thing with me! <g>
  63.  
  64. [ SCANIT! - How to set it up ]
  65. To run SCANIT on your system, this archive should include the following
  66. files.  If any are missing, please call my BBS and download a good copy.
  67.  
  68. SCANFILE.WCX    <<-- The SCANIT program
  69. SCANIT.DOC      <<-- This documentation file
  70. SCANIT3.BBS     <<-- Example SCANIT display screen
  71. SCANICFG.WCX    <<-- SCANIT Configuration Program
  72. SCANIT.CFG      <<-- Example SCANIT configuration file
  73.  
  74. Step 1.
  75. Put the files SCANFILE.WCX (SCANIT!) and SCANICFG.WCX in your
  76. \WILDCAT (Wildcat Home) directory.
  77.  
  78. Step 2.
  79. Run SCANICFG.WCX.  You can either add it as a menu item to your
  80. (*recommended*) SYSOP menu, or run it from the DOS prompt by
  81. typing: WILDCAT /RUN SCANICFG
  82.  
  83. This will create the SCANIT.CFG file needed for SCANIT to operate
  84. properly on your BBS.  Follow the on-screen prompts and enter the
  85. information required.  If the file SCANIT.CFG exists, you will enter
  86. in EDIT mode (it will load your existing SCANIT.CFG file, preserving
  87. your original settings) so you can make changes as needed.
  88.  
  89. SCANIT.CFG File Structure (sample SCANIT.CFG included in archive)
  90. c:\wildcat\wcwork\node  <<-- Path to NODE directory (Don't enter Node #'s!)
  91. C:\wildcat              <<-- Path to Wildcat HOME directory
  92. .bat                    <<-- File extensions to EXCLUDE (1 of 10)
  93. .com
  94. .sys
  95. .bmp
  96. .tif
  97. .arc
  98. .jpg
  99. .mpg
  100. .lzh
  101. .rar
  102. c:\wildcat\comment.txt <<-- Complete path\filename.ext of COMMENT file
  103. PKZIP                  <<-- Default Archiver
  104. N                      <<-- Convert to default archiver (not yet functional)
  105. 0                      <<-- Default conference for sending failed messages
  106. CALLER                 <<-- Send failed messages to (SYSOP, CALLER, BOTH, NONE)
  107. Y                      <<-- Force mail check on failed scan
  108. scanit3.bbs            <<-- Name of SCANIT display file to use
  109. 18                     <<-- Row for SCANIT status messages during scan
  110. 6                      <<-- Row to display FILENAME during scan
  111. 34                     <<-- Col to display FILENAME during scan
  112. 9                      <<-- Row to display FILE ACCEPTABILITY status
  113. 3                      <<-- Col to display FILE ACCEPTABILITY status
  114. 11                     <<-- Row to display ARCHIVE INTEGRITY status
  115. 3                      <<-- Col to display ARCHIVE INTEGRITY status
  116. 13                     <<-- Row to display VIRUS SCAN status
  117. 3                      <<-- Col to display VIRUS SCAN status
  118. 15                     <<-- Row to display SYSOP FUNCTIONS status
  119. 3                      <<-- Col to display SYSOP FUNCTIONS status
  120. 10                     <<-- Number of seconds to pause screen for FAILS
  121. 3                      <<-- Number of seconds to pause screen for PASSES
  122.  
  123. Structure
  124. 1....NodePath   (Complete path to the NODE directory - no node #'s PLEASE!)
  125. 2....Log Path   (Complete path for SCANIT.LOG file - no trailing "\"please!)
  126. 3....Exclude(1) (Excludes are UNACCEPTABLE FILE EXTENSIONS!)
  127. 4....Exclude(2) (i.e., .BMP, .JPG, .LZH, .COM, .ARC, etc.)
  128. 5....Exclude(3)
  129. 6....Exclude(4)
  130. 7....Exclude(5)
  131. 8....Exclude(6)
  132. 9....Exclude(7)
  133. 10...Exclude(8)
  134. 11...Exclude(9)
  135. 12...Exclude(10)
  136. 13...Path\filename to Comment file for ZIP/Arj files
  137. 14...Default packer (i.e., PKZIP, ARJ)
  138. 15...Convert uploads to default packer (Y/N)
  139. 16...Default Conference for Msgs (i.e., 0, 1, 2, etc.)
  140. 17...Msg To (Sysop, Caller, Both, or NONE)
  141. 18...Force mail check after failed file? (Y/N) (force caller to see msg)
  142. 19...Filename of Display File to use
  143. 20...Line number (ROW Number) for status messages
  144. 21...ROW to place FILENAME
  145. 22...COL to place FILENAME
  146. 23...ROW to place FILE ACCEPTABILITY status
  147. 24...COL to place FILE ACCEPTABILITY status
  148. 25...ROW to place ARCHIVE INTEGRITY status
  149. 26...COL to place ARCHIVE INTEGRITY status
  150. 27...ROW to place VIRUS SCAN status
  151. 28...COL to place VIRUS SCAN status
  152. 29...ROW to place SYSOP FUNCTIONS status
  153. 30...COL to place SYSOP FUNCTIONS status
  154. 31...Time to pause screen (in seconds) for FAILED FILE
  155. 32...Time to pause screen (in seconds) for PASSED FILE
  156.  
  157. *NOTE* On EXCLUDE files:
  158. Exclude files are file extensions that you DO NOT want accepted by
  159. your system!  Enter the FULL EXTENSION (including the period) for
  160. any file extension that you want excluded from your BBS.  If you
  161. only have one or two, leave the others BLANK, but the BLANK LINE
  162. _MUST_ still be there!
  163.  
  164. Here's an example.  I don't want ANYONE uploading a file with the
  165. extension .COM to my BBS!  So, I add the extension .COM to any of
  166. the EXCLUDE lines in SCANIT.CFG.  The file can _STILL_ be uploaded
  167. to the BBS, but SCANIT will flag it as having failed VIRUS CHECK
  168. in the WildCat file database. If you have the Message option
  169. turned on, a message will be sent to whom you have directed informing
  170. them of the failure.  I personally want a message sent to ME
  171. (the sysop) informing me that a file has failed scan (saves me from
  172. having to check the logs!  Since I check my mail everytime I log on,
  173. I know immediately if there is a problem file on the system and can
  174. take action to deal with it).
  175.  
  176. *NOTE ON COMMENT FILES*
  177. ZIP/ARJ files can have imbedded COMMENT files placed in them that
  178. appear to the person unarchiving (unzipping) them.  This is a
  179. nice touch that let's you:
  180. 1. Advertise your system
  181. 2. Let's a caller see where they downloaded the file from
  182.  
  183. It is a pure ASCII text file and can be as many lines long as you
  184. want (up to 64K in most instances).  However, it is best if you
  185. keep this file to not more than about 15-20 lines long for best
  186. readability by user when the file is unarchived.  Here's a
  187. sample of what a zip comment can look like:
  188. ----------- EXAMPLE COMMENT.TXT file -------------
  189. *
  190.            ┌╦═══╦┐ ┌╦═══╦┐ ┌╦═══╦┐ ┌╦═╗ ╦┐ ┌═╤╦╤═┐ ┌═╤╦╤═┐ ╒╦╕
  191.            └╩═══╦┐ │║      ├╬═══╬┤ │║ ║ ║│   │║│     │║│   ╘╩╛
  192.            └╩═══╩┘ └╩═══╩┘ └╩   ╩┘ └╩ ╚═╩┘ └═╧╩╧═┘   ╧╩╧   └╩┘
  193.        This file was downloaded from Green Acres! BBS in Clovis, NM!
  194.       It was archive/virus tested using SCANIT and McAfee's VirusScan!
  195.  
  196. ----------- End Example --------------------------
  197.  
  198. Hint:
  199. Notice the "*" (asterisk) at the top of the example.  You need to put
  200. SOMETHING on the top line of a COMMENT.TXT file (doesn't matter what
  201. character you use) to cause the file to be displayed correctly to the
  202. user unarchiving it. Spaces or blank lines _can_ be ignored, so put a
  203. "-" or "*" or something there!
  204.  
  205.  
  206. Step 3.
  207. After creation of the SCANIT.CFG file, change to your \WILDCAT\BATCH
  208. directory.  If you have a file there called SCANFILE.BAT, rename it
  209. to SCANFILE.OLD (or delete it).  SCANIT does not use this file, but
  210. if it exists, it will override SCANFILE.WCX from running.  If you
  211. do not have a FILEDESC.BAT file, I _STRONGLY_ suggest that you create
  212. one.  Here is what it looks like:
  213.  
  214. EXAMPLE FILEDESC.BAT:
  215. pkunzip %1 FILE_ID.DIZ DESC.SDI
  216. arj e %1 FILE_ID.DIZ DESC.SDI
  217.  
  218. Wildcat automatically executes this file, if it exists, after each
  219. upload and will extract the files FILE_ID.DIZ and DESC.SDI (if the
  220. file has them) and will use these for the file description in the
  221. Wildcat file database.  This batch file needs to be in your
  222. WILDCAT\BATCH directory.  The above example extracts this information
  223. from a ZIPped or ARJed file.
  224.  
  225. Step 4.
  226. Create a display file that the caller (and you) see during the scan
  227. process.  You can use the one that comes in the archive (SCANIT3.BBS),
  228. or design your own using WCDraw, BullDraw, or TheDraw.
  229.   4a. The display file you create MUST be placed in the DISPLAY file
  230.       directory!  If you run MULTIPLE DISPLAY FILE directories on
  231.       your BBS, then it must be in ALL of them!  The display file
  232.       directory, for you "just starting" WildCat SysOps, is usually
  233.       \WILDCAT\DISP.
  234.   4b. Look at the docs above to see how each item that SCANIT
  235.       places on screen is performed.  YOU tell SCANIT where to
  236.       display the filename, file acceptability, archive integrity,
  237.       virus scan, and sysop function information!  Be aware
  238.       that the SCANIT status message row is used from Col 2 to
  239.       Col 76 when drawing your screens.
  240.   4c. Do _NOT_ make your screen longer than 21 lines!  Lines 22
  241.       and 23 are reserved by SCANIT to display copyright information
  242.       and will overwrite whatever you place there.
  243.  
  244. Step 5.
  245. You are now finished and are ready to start scanning uploads!
  246.  
  247. If a file fails scan, SCANIT will:
  248.  1. Create/update a log file called SCANIT.LOG in the directory
  249.     you have specified with the information regarding the reason
  250.     for failure.
  251.  
  252.  2. Flag the file in the Wildcat file database as having failed scan.
  253.  
  254.  3. <IF> you have the auto-messaging toggle turned on in SCANIT.CFG,
  255.     SCANIT will send a message (or messages) to the party(s) as
  256.     configured informing them of the failure.
  257.  
  258.  
  259. [ Files you _MUST_ have on your system for SCANIT to work! ]
  260. If you want SCANIT to work properly, you *MUST* have the following
  261. programs installed on your system:
  262.  
  263. 1. MOST IMPORTANT! McAfee's VirusScan! (SCAN.EXE)
  264. 2. PKZIP 2.04g (or newer version)
  265. 3. ARJ 2.41  (or newer version)
  266.  
  267. ALL of these programs _MUST_ be in a directory that is in your PATH
  268. statement!  If you don't have any of these programs, you can download
  269. or FREQ them from my BBS.  If you are FREQing them, here are the
  270. file names:
  271.  
  272. PKZIP 204G - PKZ204G.EXE (Self-extracting Archive)
  273. ARJ 2.41   - ARJ241E.EXE (Self-extracting Archive)
  274. For McAfee's Virus Scan: The filename on this changes often!
  275. You _should_ be able to find it on any system in your area (locally)
  276. and save yourself a long distance phone call (as with the others)!
  277. But, if you can't, call up my BBS to ensure you get the newest version.
  278.  
  279. [ Notes to BETA Sites ]
  280. I'm willing to do just about anything to this thing to make it easy to
  281. use and still do a good job.  I want to keep the price at $10.00 (I
  282. was gonna ask $15.00, but most of us on a tight budget have a hard
  283. enough time with $10.00 regs!).  My goals for Scanit are:
  284.  
  285. 1) Make it easy to set up and run
  286. 2) Make it reliable so you don't have to worry about it running! <g>
  287. 3) Keep it inexpensive so more sysops run a scanner!!!!
  288. 4) Support the major archivers (ZIP, ARJ - LZH later)
  289.  
  290. [ Notes to Myself for Updates ]
  291. Note:
  292.       Add- LHARC Support (in work)
  293.       Add- RIP stuff
  294.       Add- INCLUDE FILE in archive <Your BBS ad, etc>
  295.       Add- Remove junk files <Other BBS ads,etc> list
  296.       Add- Use text file for messages or 1-liner from Scanit
  297.       Add- User created display file support (in work)
  298.       Add- Multiple display screen support (Randomly displayed)
  299.       Add- Minimum baud rate to display full-color screens to
  300.       Add- Send msg if file passes <optional>
  301.       Add- DATE checking
  302.       Add- GIF testing
  303.       ? Add- DELETE FAILED FILES FROM DISK/DATABASE (sysop configurable)
  304.       ? Add- MOVE FAILED FILES TO AREA function (sysop configurable)
  305.  
  306.       *Note* ? flags - Are these options REALLY necessary since
  307.                        failed files are marked as having failed
  308.                        scan in the WC file database and are
  309.                        therefore inaccessable by all but the
  310.                        sysop anyway?  Let me know how you
  311.                        feel about it.
  312.  
  313. Considerations (let me know how you feel about these):
  314.       Possibly create display file (sysop configurable) to display
  315.       the results of scans and show what files have been uploaded,
  316.       and by whom, daily.
  317.  
  318.  
  319. PLEASE! PLEASE! PLEASE!
  320. Drop me mail and let me know if you encounter a problem with SCANIT, or
  321. if there is something you want added or changed!  You can reach me on
  322. my BBS (Green Acres! BBS - 1200-14400 Baud (505)763-5129) or netmail
  323. me via 1:318/4.
  324.  
  325. [ License Agreement ]
  326.  
  327.        1. Proprietary Rights and Obligations:   SCANIT is the valuable
  328.        property of Blake Software.   You agree not to  modify, adapt,
  329.        translate, reverse engineer, decompile, disassemble, create
  330.        derivative works based on SCANIT or any part of it.
  331.        Trademarks  shall  be  used  in accordance with accepted trademark
  332.        practice, including identification of trademark owners name.
  333.  
  334.        This license agreement refers to: SCANIT!
  335.        At each mention of the term "program" SCANIT is being
  336.        referred to as well.
  337.  
  338.        SCANIT may be used on any computer your own or operate, as
  339.        long as there is no possiblity of it being used on two or more
  340.        computers at the same time (concurrent copies of it may NOT be
  341.        in operation).  The license for SCANIT may not be given or
  342.        transferred to any other individual, company, corporation or
  343.        entity.  It is valid for the original licensee only.  Failure
  344.        to comply with this license agreement immediately revokes your
  345.        license to use SCANIT.
  346.  
  347.        2. Right of Ownership:  Blake Software  retains  title
  348.        and ownership  of  SCANIT.  This Agreement does NOT grant
  349.        you any rights to intellectual property rights in SCANIT.
  350.        This Agreement does NOT grant you any rights to use of the
  351.        trademarks.  SCANIT is protected by copyright laws and
  352.        international treaty.
  353.        
  354.        7. Limited Warranty:  SCANIT is provided "as is"  without warranty
  355.        of any kind,  either  expressed  or  implied,  including  but  not 
  356.        limited to the fitness for a particular purpose.   The entire risk 
  357.        as to the quality and performance of SCANIT is with you.  Should
  358.        the software prove defective, you (not Blake Software) assume
  359.        the entire cost  of all necessary   servicing,  repair  or
  360.        correction. Blake Software does not warrant that SCANIT will
  361.        meet your requirements or that the operation of SCANIT will be
  362.        uninterrupted or error free.
  363.        
  364.        8. Limit of Liability: In NO event will Blake Software be liable
  365.        to YOU  for any  consequential  or  incidental damages, including
  366.        lost profits or lost savings,  or for any claim by any party,
  367.        even if a representative of Blake Software has been advised of
  368.        the possibility of such damages.
  369.        
  370.        9. Term:  The  Licence  Agreement  is effective  until terminated.  
  371.        Blake Software has the right to terminate your licence immediately
  372.        if you fail to comply with the terms  of this  Licence Agreement.
  373.        Blake Software retains the right to  stop supporting SCANIT at
  374.        any time without any notice.
  375.        
  376.        10. Governing Law:  This Licence Agreement will be governed by the 
  377.        Laws  of the  state of New Mexico, USA, and you specifically
  378.        attorn to the jurisdiction of the courts of New Mexico, in
  379.        the Judicial District of Curry County, for any proceedings relating
  380.        to this Licence Agreement.
  381.  
  382.  
  383.  
  384. [ DISCLAIMER ]
  385. I will not be responsible for any losses (whether time, data,
  386. hardware, or any form of loss) you might incur from the use of this
  387. program (SCANIT).  If you do not agree to hold me harmless, then
  388. you may not use this software.  Your use of SCANIT is your agreement
  389. to hold me harmless in any loss you might incur, either directly or
  390. indirectly, from it's use even if Blake Software or an agent thereof
  391. has been advised beforehand of a possible or existing problem.
  392.  
  393. SCANIT is the copyright of Blake Software, 1994/1995, and is protected
  394. by U.S. and international copyright laws.  It may not be decompiled,
  395. reverse engineered, altered, or tampered with in any way.  Doing so
  396. is a violation of U.S. and international law and is punishable by
  397. those laws.
  398.  
  399.